home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Standards 1994 January / InfoMagic Standards - January 1994.iso / iso / 9660 / rockrdge / rrg.11 / api.begin.nr next >
Text File  |  1992-08-19  |  2KB  |  54 lines
  1. .sp
  2. .H 1 "RRIP APPLICATION PROGRAMMING INTERFACE (API)"
  3. .sp
  4. This section specifies an Application Programming Interface (API)
  5. for the Rock Ridge Interchange Protocol which is implemented on top
  6. of the System Use Sharing Protocol. This API is a supplement to the
  7. X/Open CD-ROM Support Component (XCDR).
  8. .sp
  9. .H 2 "Mapping Device Files"
  10. .sp
  11. The major and minor numbers of device files as recorded in the System
  12. Use Area on the CD-ROM may not match the major and minor numbers
  13. of the physical devices. 
  14. If that is the case, the command,
  15. .I cddevsuppl\^
  16. can be used to change the major and minor numbers of a specific
  17. device file on the CD-ROM.
  18. .sp
  19. If the system imposes a maximum value on the number of device file 
  20. mappings, this will be defined via the symbolic name CD_MAXDMAP in
  21. .I <sys/cdrom.h>.\^
  22. At least 50 device file mappings will be supported.
  23. .sp
  24. .H 2 "Obtaining CD-ROM Specific Information"
  25. .sp
  26. .H 3 "System Use Sharing Protocol Fields"
  27. .sp
  28. The CD-ROM contains System Use Fields in the System Use Areas which are
  29. specific to the CD-ROM and cannot be obtained by standard XSI system 
  30. interfaces.
  31. Using the command
  32. .I cdsuf,\^
  33. or the equivalent library function, all additional information in a
  34. file or directory System Use Field can be accessed.
  35. .sp
  36. .H 3 "Changing PX Field Information"
  37. .sp
  38. The "POSIX File User ID" and "POSIX File Group ID" can be mapped on the
  39. receiving system by using commands and library functions supplied by
  40. the X/Open CD-ROM Support Component (XCDR).
  41. .sp
  42. .H 3 "File Name Resolution"
  43. .sp
  44. The fields
  45. .I file,\^
  46. .I filename,\^
  47. .I path,\^
  48. and
  49. .I pathname\^
  50. shall be resolved according to the Rock Ridge Interchange Protocol, which
  51. may be the ISO 9660 name or RRIP name depending on whether an "NM" System
  52. Use Field is present for any component of that filename.
  53. .bp
  54.